docs/images/breakout-stamps.png

<EFBFBD>PNG


IHDRd<00>?<3F><><EFBFBD>KIDATx<54><78><EFBFBD>!JDa<18>Q<EFBFBD><51><EFBFBD>N3<4E><33>4k<34>	<13><01> <05>]<5D>&<11>m<EFBFBD><6D>q
<0F>˅<EFBFBD>s<16><><EFBFBD><EFBFBD>oz<<3C><1C><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>+++++++++++++`P<><50><EFBFBD>d<EFBFBD>f<>{<7B>[t<>7<0C>
<EFBFBD>
<EFBFBD>
<EFBFBD>
<EFBFBD>
<EFBFBD>
<EFBFBD>
<EFBFBD>
<EFBFBD>
<EFBFBD>
<EFBFBD>
<EFBFBD>
<EFBFBD>
<EFBFBD><18><>}<7D>_<EFBFBD><5F>ٜo<D99C><16><>
<03><02><02><02><02><02><02><02><02><02><02><02><02><02>5ݼ^<5E>}<7D>l<EFBFBD>n?<17><>
<03><02><02><02><02><02><02><02><02><02><02><02><02><02>5<>}|<7C>}<7D>l^<5E>.<16><>
<03><02><02><02><02><02><02><02><02><02><02><02><02><02>5<>Ϟ׾a6<61><36><EFBFBD><EFBFBD><EFBFBD><EFBFBD>a V V V V V V V V V V V V V <00><><EFBFBD><18><12>(<<3C>IEND<4E>B`<60>
-												Add two Breakout examples and the tutorials that build them

Two complete games in `examples/breakout/`, both 100% BASIC: `characters/`
draws its wall in the text grid with two `DATA` sprites for the ball and
paddle, and `sprites/` loads CC0 artwork and captures its whole screen with
`SSHAPE`/`SPRSAV`. They take opposite shapes for reasons that are entirely
this interpreter's, which is what the chapters are for.

`docs/17-tutorial-breakout.md` and `docs/18-tutorial-breakout-artwork.md`
build each one a step at a time, and end in a checklist of the rules a real
program runs into: create every name before the loop starts, write a text row
whole, loop with `GOTO` rather than `DO`, put the float on the left. Every
trap is a runnable block with its own output rather than a claim -- the value
pool dying at four thousand names, the skipped `BEGIN` block that breaks its
caller's `RETURN`, `SSHAPE` ignoring a subscript, `READ`'s single cursor.

Five figures, generated from the listings beside them by `docs_screenshots`,
and a `breakout_art` setup so the ones that load artwork load the example's
own. The character game's wall cannot be photographed -- the screenshot host
omits the text layer on purpose -- so it is shown as compared output instead.

`docs/07-sound.md` never said `SOUND`'s frequency is a SID register value
rather than hertz, which both games depend on. It says so now, with the
conversion from `src/audio_tables.c:84`.

`TODO.md` gains the thirteen defects the two games turned up -- §6 items 30
to 33 and all of §9 -- each with a reduction that fits on a screen, the file
and line of the cause, and what a fix would touch.

Verified: `docs_examples` passes in both build configurations,
`docs_screenshots --check` re-renders all thirteen figures and byte-compares
them, the full 109-test suite passes in both builds, every quoted fragment
was checked to appear verbatim in the listing it came from, and every
relative link and anchor resolves.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

											
										
										
											2026-08-01 22:54:42 -04:00
+								<EFBFBD>PNG
 IHDRd<00>?<3F><><EFBFBD>KIDATx<54><78><EFBFBD>!JDa<18>Q<EFBFBD><51><EFBFBD>N3<4E><33>4k<34>	<13><01> <05>]<5D>&<11>m<EFBFBD><6D>q
<0F>˅<EFBFBD>s<16><><EFBFBD><EFBFBD>oz<<3C><1C><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>+++++++++++++`P<><50><EFBFBD>d<EFBFBD>f<>{<7B>[t<>7<0C>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD>
 								<EFBFBD><18><>}<7D>_<EFBFBD><5F>ٜo<D99C><16><>
<03><02><02><02><02><02><02><02><02><02><02><02><02><02>5ݼ^<5E>}<7D>l<EFBFBD>n?<17><>
<03><02><02><02><02><02><02><02><02><02><02><02><02><02>5<>}|<7C>}<7D>l^<5E>.<16><>
<03><02><02><02><02><02><02><02><02><02><02><02><02><02>5<>Ϟ׾a6<61><36><EFBFBD><EFBFBD><EFBFBD><EFBFBD>a V V V V V V V V V V V V V <00><><EFBFBD><18><12>(<<3C>IEND<4E>B`<60>